package com.example.ywr.service;

import com.example.ywr.common.PageParam;
import com.example.ywr.common.PageResult;
import com.example.ywr.entity.User;

import java.util.List;

/**
 * 用户服务接口
 */
public interface UserService {

    /**
     * 注册用户
     *
     * @param user 用户信息
     * @return 注册后的用户信息
     */
    User register(User user);

    /**
     * 更新用户
     *
     * @param user 用户信息
     * @return 更新后的用户信息
     */
    User update(User user);

    /**
     * 根据ID删除用户
     *
     * @param id 用户ID
     * @return 是否删除成功
     */
    boolean delete(Long id);

    /**
     * 批量删除用户
     *
     * @param ids 用户ID列表
     * @return 是否删除成功
     */
    boolean batchDelete(List<Long> ids);

    /**
     * 根据ID获取用户详情
     *
     * @param id 用户ID
     * @return 用户详情
     */
    User getById(Long id);

    /**
     * 根据用户名获取用户详情
     *
     * @param username 用户名
     * @return 用户详情
     */
    User getByUsername(String username);

    /**
     * 根据手机号获取用户详情
     *
     * @param phone 手机号
     * @return 用户详情
     */
    User getByPhone(String phone);

    /**
     * 根据邮箱获取用户详情
     *
     * @param email 邮箱
     * @return 用户详情
     */
    User getByEmail(String email);

    /**
     * 分页查询用户列表
     *
     * @param pageParam 分页参数
     * @return 用户列表
     */
    PageResult<User> list(PageParam pageParam);

    /**
     * 根据用户名模糊查询
     *
     * @param username  用户名
     * @param pageParam 分页参数
     * @return 用户列表
     */
    PageResult<User> listByUsername(String username, PageParam pageParam);

    /**
     * 根据昵称模糊查询
     *
     * @param nickname  昵称
     * @param pageParam 分页参数
     * @return 用户列表
     */
    PageResult<User> listByNickname(String nickname, PageParam pageParam);

    /**
     * 根据角色查询用户
     *
     * @param role      角色
     * @param pageParam 分页参数
     * @return 用户列表
     */
    PageResult<User> listByRole(String role, PageParam pageParam);

    /**
     * 更新用户状态
     *
     * @param id     用户ID
     * @param status 状态
     * @return 是否更新成功
     */
    boolean updateStatus(Long id, Integer status);

    /**
     * 批量更新用户状态
     *
     * @param ids    用户ID列表
     * @param status 状态
     * @return 是否更新成功
     */
    boolean batchUpdateStatus(List<Long> ids, Integer status);

    /**
     * 用户登录
     *
     * @param username 用户名
     * @param password 密码
     * @return 登录成功的用户信息
     */
    User login(String username, String password);

    /**
     * 修改密码
     *
     * @param id          用户ID
     * @param oldPassword 旧密码
     * @param newPassword 新密码
     * @return 是否修改成功
     */
    boolean updatePassword(Long id, String oldPassword, String newPassword);

    /**
     * 重置密码
     *
     * @param id       用户ID
     * @param password 新密码
     * @return 是否重置成功
     */
    boolean resetPassword(Long id, String password);
}